home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / telecomm / 378 / xyz / xyz.doc next >
Text File  |  1989-11-03  |  33KB  |  925 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                    XYZ.TTP
  8.                                    =======
  9.                                By Alan Hamilton
  10.  
  11. WHAT IT IS
  12. ==========
  13. Here it is.... a new ZMODEM program for the Atari ST.  I was frustrated by the
  14. limitations that the ST version of RZ.TTP had, so I wrote my own, and I'm
  15. willing to fix any bugs that turn up in it.
  16.  
  17. Features include:
  18. 1.  Transfers all files unchanged -- "binary" mode.  No more truncated files.
  19. 2.  Transfers files at the maximum speed the sender can send them.  No "wait
  20. states."
  21. 3.  The timestamps on the files are preserved, unless you don't want them to
  22. be.  You are told, in regular calendar format, what the timestamp is.
  23. 4.  Interrupted transfers can be restarted where they left off (in ZMODEM).
  24. 5.  You are kept informed as to how much of the file has actually been
  25. received, not how many bytes have been received in the current session.  If
  26. you tried to restart a transfer with RZ.TTP, you wouldn't know where you
  27. were.
  28. 6.  There is no feature six.
  29. 7.  Filenames that aren't compatible with the ST are transformed into ones
  30. that are, not just truncated at the first illegal character.  If they can't be
  31. converted, a random filename is chosen.  These transformed filenames are
  32. unique -- no more losing a file because after being truncated it was the same
  33. as a previous filename.
  34. 8.  Works with all ST/Mega configurations.
  35. 9.  Includes versions of XMODEM and YMODEM for completeness.
  36. 10.  It's -*>FREE<*-  No vicious licencing agreement or shareware guilt trip
  37. here.  This program may be copied, given away, folded, spindled, mutilated, or
  38. sold into slavery.
  39.  
  40.  
  41. REVISION HISTORY
  42. ================
  43. 11-3-89:  v.1.42:  In 1.41, if you were disconnected while using ZMODEM,
  44. XYZ.TTP would not time out, and you would not be able to use the UNDO key to
  45. abort.  The only way out would be to reset the computer.  The console bell now
  46. rings at the end of a file transfer session.
  47.  
  48. 10-21-89:  v1.41:  Lots o' changes this time:
  49. 1.  If v1.3 of XYZ.TTP was started before the sender started up, XYZ.TTP would
  50. bomb.  Fixed.
  51. 2.  A bug in handling of file creation dates in YMODEM has been fixed.
  52. 3.  XMODEM and YMODEM now use disk buffering.
  53. 4.  File errors are now more explicit as to what the problem is.
  54. 5.  ZMODEM now can handle speeds over 9600 baud.
  55. 6.  XMODEM and YMODEM now indicate how fast the files were transferred.
  56. ZMODEM no longer overstates the transfer rate if you are restarting a
  57. transfer.
  58. 7.  Handling of retries is different.  In earlier versions, the retry limit
  59. (before aborting) was supposed to be ten, but a bug made it only five.  This
  60. has been fixed, and a new option has been added to let you specify a retry
  61.  
  62.  
  63.  
  64.  
  65.                                     - 1 -
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73. limit.  Put -r<n> on the command line, with <n> replaced by the number of
  74. retries (up to 1000).  For example, -r25 would give you 25 retries.
  75. 8.  Some messages that were similar in YMODEM and ZMODEM were changed to be
  76. exactly the same.
  77. 9.  Some of the C library code has been replaced with code of my own, making
  78. XYZ.TTP about 4k smaller.
  79.  
  80. 10-1-89:  v1.3  At long last, disk buffering is here!  Rather than saving
  81. after every packet, XYZ.TTP only does a disk write after all available memory
  82. has been filled up.  XYZ.TTP now lets you start it before the sender has
  83. started.  This was attempted in v1.2, but a bug in the code would make XYZ.TTP
  84. bomb if you tried it.  That has been fixed.  A disk full condition is now
  85. reported, rather than just a generic "File error" if the disk doesn't have
  86. enough room for the file.  A new option -p will make XYZ.TTP wait for you to
  87. press a key before exiting.  This can be handy if you are running XYZ.TTP from
  88. the Desktop.
  89.  
  90. 9-19-89:  v1.2  Up to now, if XYZ.TTP got five CTRL-X's while waiting for a
  91. ZMODEM frame to start, it would abort with a "Sender aborted" error.  Now it
  92. only aborts if it gets five *consecutive* CTRL-X's.  Unexpected aborts most
  93. often happened during recovery of CRC errors.  Now sends hardware break signal
  94. correctly.  XYZ.TTP now handles timeout errors better.
  95.  
  96. 9-15-89:  v1.1:  A rather stupid error regarding filename conversion has been
  97. fixed.  XYZ.TTP would sometimes insert a '.' in the seventh or eighth position
  98. of a filename, regardless of whether it was appropriate or not.  The help
  99. screen (printed in response to the -h option) has been rearranged.
  100.  
  101. 9-13-89:  XYZ.TTP v1.0 released.  Implements ZMODEM for the first time.
  102. Buffer overflow at high bps rates fixed.  Synchronization error in YMODEM
  103. fixed (again!).  UNDO key handling improved.  The documentation file, XYZ.DOC,
  104. is totally new.  XY.DOC is no longer applicable.
  105.  
  106. 7-2-89:  XY.TTP v0.5 released.  Handles only XMODEM and YMODEM.  Early release
  107. to accommodate changes made to GEnie software that Flash(tm) could not
  108. handle.
  109.  
  110. DISCLAIMER
  111. ==========
  112. My obligations to you are exactly the same as your obligations to me:  NONE.
  113. Although I have tested this program as best I can, you use this program only
  114. at your own risk.  I will not be responsible for any losses you suffer from
  115. using it.
  116.  
  117.  
  118. ACKNOWLEDGMENTS
  119. ===============
  120. XMODEM was developed by Ward Christenson.
  121. YMODEM and ZMODEM were developed by Chuck Forsberg, Omen Technology.
  122. CRC code by Stephen Satchell, Satchell Evaluations and Chuck Forsberg, Omen
  123. Technology.
  124. Flash is a trademark of Antic Publishing.
  125. C library code copyright (C)1988 by the Mark Williams Company.
  126. 520ST, 1040ST, and Mega ST are trademarks of Atari, Inc.
  127.  
  128.  
  129.  
  130.  
  131.                                     - 2 -
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139. GEnie is a trademark of GEISCO/General Electric.
  140.  
  141. WHAT IT ISN'T
  142. =============
  143. Although XYZ.TTP supports the most useful parts of the ZMODEM protocol, there
  144. are a few things that aren't.
  145.  
  146. 1.  32 bit CRCs.  XYZ.TTP only uses 16 bit CRCs, which should be sufficient
  147. unless you are really paranoid about data integrity.
  148. 2.  Commands.  This part of the ZMODEM protocol was intended to allow you to
  149. remotely control a system.  Since XYZ.TTP is intended to be manually operated,
  150. and the ST doesn't have a standard command line interface, commands are not
  151. accepted.
  152. 3.  Compression.  Neither run-length encoding (RLE) nor Lempel-Ziv-Welch (LZW)
  153. compression is supported.  If you use a separate decompression utility, this
  154. isn't needed.  You can receive files that have already been compressed; you
  155. just need to use a separate utility to do the decompression.  XYZ.TTP will not
  156. do the decompression itself.
  157. 4.  Challenges.  XYZ.TTP does not try to verify that it is connected to a
  158. system that is ready for ZMODEM.  It assumes that you have already told that
  159. system to go to ZMODEM.
  160. 5.  Pathnames.  XYZ.TTP will put all files into the default folder, or one
  161. that you specify on the command line.  Any path information that is sent with
  162. the file is ignored.
  163. 6.  Selective file replacement.  The ZMODEM protocol lets you selectively
  164. transfer files based on whether they exist or don't exist at the receiver, or
  165. whether they are different in file size, date, or CRC.  XYZ.TTP only does one
  166. of two things:  If a file does not exist, it is transferred in its entirety.
  167. If it does exists, it assumes that you are resuming a file transfer that was
  168. aborted, and tries to resume at the end of what you have.
  169. 7.  File transmission resumption.  Do not try to download a file that already
  170. exists on your disk unless you are trying to recover an aborted transfer.  The
  171. file will be damaged if it is a different file, despite having the same name.
  172. If the file was previously received in its entirety, and you try to restart a
  173. download on it, it probably won't be damaged, but this depends on how the
  174. sender reacts, so be careful.
  175. 8.  Disk space check.  If the sender tries to check on how much space you have
  176. available on your disk, XYZ.TTP will always tell it that you have an unlimited
  177. amount.  This was done because checking the disk space is a very slow
  178. operation on hard drives.  Activating this feature might be done in future
  179. versions if enough people request it.
  180. 9.  Encrypting.  File encryption is not supported.
  181. 10.  Seven bit transfers.  Transferring eight bit files (non-text files) over
  182. lines that only support seven bits per character is not supported.  This is
  183. something you'd only run into with a mainframe.
  184. 11.  Sparse files.  Transferring selected portions of a file that's mostly
  185. zeros is not supported.  The entire file must be sent.
  186. 12.  XYZ.TTP does not contain oat bran.
  187.  
  188.  
  189. HOW TO USE IT
  190. =============
  191. XYZ.TTP is mainly intended to be run from inside a regular telecommunications
  192. terminal program.  Because of this, it does not alter the settings of your
  193.  
  194.  
  195.  
  196.  
  197.                                     - 3 -
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205. ST's RS232 port from what the terminal program has set them to.  For XYZ.TTP
  206. the RS232 port should be set as follows:
  207.  
  208. Baud (or bits per second or BPS):
  209. This should match what the system you are connecting with requires, and what
  210. your modem is capable of.
  211. Data bits:  8
  212. Parity:     None
  213. Stop bits:  1 or 2
  214. Flow control:
  215. XOFF/XON (also called DC2/DC4):   OFF for XMODEM and YMODEM
  216.                                   either ON or OFF for ZMODEM
  217. RTS/CTS:    OFF, unless you are using a high-speed modem that requires it
  218.             to be on.
  219.  
  220. These settings are very common, so you probably won't have to change them.
  221.  
  222. If you can't run programs from within your terminal program, you will have to
  223. exit to the Desktop to run XYZ.TTP.  Set the remote system to download ZMODEM,
  224. then exit your terminal program.  Open XYZ.TTP, and a dialog box will appear.
  225. Type in the options (see below for a list), click on OK, and the ZMODEM
  226. transfer will start.  One of the options you will want to specify is -p which
  227. will make XYZ.TTP pause before it returns to the GEM Desktop.  If you don't
  228. specify a folder to download to, the files will go into the same folder that
  229. XYZ.TTP was in.  After ZMODEM completes, it will exit back to the Desktop.
  230. You may then rerun your terminal program and continue.
  231.  
  232. If you can run programs from within your terminal program, life gets much
  233. easier.  If, however, your terminal program doesn't let you pass parameters to
  234. a .TTP program, you will only be able to download only with ZMODEM and to the
  235. default folder.  See the manual for your terminal program for directions on
  236. running other programs.  In Flash, the command is "exec xyz.ttp" (omit the
  237. quote marks).  Any options go after the program name.  If you are keeping
  238. XYZ.TTP in a different folder than the default one, you will have to specify
  239. it:  "exec c:\telecom\xyz.ttp".  You can even program a function key to run
  240. XYZ.TTP, and download with the push of one button.  Program the key you want
  241. with ">exec xyz.ttp|", along with any options you want.  (See the Flash manual
  242. on setting function keys.)  After XYZ.TTP completes, you will be returned to
  243. Flash.
  244.  
  245.  
  246. JANE, STOP THIS CRAZY THING!
  247. ============================
  248. If you want to abort a transfer before it is complete, press the UNDO key.
  249. XYZ.TTP will send an abort sequence to the remote system and terminate.  Keep
  250. in mind that some mainframes take their own sweet time responding to abort
  251. sequences, so you may see a long string of garbage on your screen, or the
  252. mainframe may seem to have locked up.  If you are using ZMODEM, you can
  253. restart the transfer of a partially transferred file later.
  254.  
  255.  
  256. OPTIONS
  257. =======
  258. You should specify any options you want in the GEM dialog box (if running from
  259.  
  260.  
  261.  
  262.  
  263.                                     - 4 -
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271. the Desktop) or after XYZ.TTP's program name if running from a command line
  272. like the one in Flash.  They should be separated by spaces, and may be in
  273. either upper or lower case.  Following the options, you may specify a folder
  274. to download to.  If you don't specify one, the files will go into the default
  275. folder.  For XMODEM, in addition to the optional folder specification, you
  276. *must* give a filename, as XMODEM transfers don't send filenames.
  277.  
  278. -x  Download XMODEM
  279. Downloads using the original XMODEM protocol.  You can also specify the -c
  280. option if you are dealing with a very old system that does not support CRC
  281. error detection.  You must specify a filename to download to.
  282. Examples:  -x foo.txt              Download "foo.txt" to the default folder
  283.            -x -c c:\fold\moby.txt  Download "moby.txt" to the "fold" folder
  284.                                    on drive C using checksum error detection
  285.  
  286. -y  Download YMODEM
  287. Downloads using the YMODEM batch protocol.  You don't specify a filename with
  288. this, just a folder.  If you do specify a filename, or a folder that doesn't
  289. exist, you will get a file error.
  290. Examples:  -y                     Download files to the default folder
  291.            -y deep                Downloads to the "deep" folder that is
  292.                                    within the default folder
  293.            -y e:\                 Downloads to the root of drive E
  294.  
  295. -z  Download ZMODEM
  296. Downloads using the ZMODEM batch protocol.  Since ZMODEM is the default
  297. protocol, the -z is optional.  Again, you don't give a filename, just a
  298. folder.  If the file that is being received exists in the folder you are
  299. downloading to, XYZ.TTP will assume that you are resuming an interrupted file
  300. transfer, and will start the transfer at the end of what you've already got.
  301. Examples:  (no options)           Download files to the default folder
  302.            -z                     Download files to the default folder
  303.            lex\grep               Download files to the "grep" folder that
  304.                                    is within the "lex" folder that is within
  305.                                    the default folder
  306.  
  307. -p  Pause
  308. If you are running XYZ.TTP from the Desktop, you won't be able to see any
  309. error messages when it exits, as the Desktop wipes them out.  Putting -p on
  310. the command line will make XYZ.TTP prompt you to press a key before it exits.
  311.  
  312. -h  Help
  313. This causes a short description of the available options to print out, along
  314. with the current version number.  Giving an invalid option gets you this
  315. display, too.
  316.  
  317. -t  Touch
  318. This makes XYZ.TTP "touch" (set the time and date to the current time and
  319. date) files that it downloads.  If the sender specifies a creation time and
  320. date for a file, that is kept.  The -t option makes XYZ.TTP use the current
  321. time and date instead.  If the creation time and date isn't specified by the
  322. sender, the current time and date is put on the file.  XMODEM will always use
  323. the current time and date.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                     - 5 -
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337. -v<file>  Verbose mode
  338. This causes XYZ.TTP to output special debugging information.  If no file is
  339. specified, the output goes to the screen.  If a file is specified, it should
  340. be directly after the "v" (no spaces), and output will go to it, along with
  341. any error messages you might get.  If you have problems with XYZ.TTP, run it
  342. with the -v option, and send the file it creates along with any comments to
  343. me.
  344. Examples:  -v             Download ZMODEM, sending debug info to screen
  345.            -ve:\log.txt   Download ZMODEM, sending debug info to "log.txt"
  346.                           on drive E:
  347.  
  348. -r<n>   Set retry limit
  349. Ordinarily, XYZ.TTP will abort a transfer if more than ten errors occur.  When
  350. you have had that many errors, the chances of an error slipping through
  351. undetected become greater.  If, however, you want to take your chances, you
  352. can set the retry limit with this command.  It can be set anywhere from the
  353. default 10 up to 1000.
  354. Example:  -r50     Set XYZ.TTP's retry limit to 50
  355.  
  356.  
  357. HE'P ME, HE'P ME, I BE HYP-MO-TIZED
  358. ===================================
  359. If you have trouble with XYZ.TTP, send a copy of a debug file (see the -v
  360. option above) along with your comments to me on the GEnie network at
  361. A.HAMILTON1.  Be sure to mention the version of XYZ.TTP you are running -- run
  362. it with the -h (help) option to check it.
  363.  
  364.  
  365. ERROR MESSAGES
  366. ==============
  367. Something that has always ticked me off is getting an error message
  368. from the program I'm using, looking it up in the manual, and finding
  369. that IT'S NOT THERE!  So, what follows is a complete listing, in
  370. alphabetical order, of every possible message that XYZ.TTP can produce,
  371. along with an explanation.  Many of these messages are for debugging
  372. purposes, and others you should never under ordinary circumstances run
  373. into.
  374.  
  375. Access denied  (XMODEM/YMODEM/ZMODEM)
  376. >>The ST could not open a file either because the file exists and is set
  377.   to read only, or a folder exists with that same name.
  378.  
  379. Attn string:  <hex bytes>  (DEBUGGING/ZMODEM)
  380. >>This details the string the sender wants XYZ.TTP to use to interrupt it.
  381.  
  382. Average transfer rate = <number> cps  (XMODEM/YMODEM/ZMODEM)
  383. >>This gives the average throughput.
  384.  
  385. Bad escape char <hex byte>  (ZMODEM/DEBUGGING)
  386. >>An invalid escape sequence was received.  Probably caused by line noise.
  387.  
  388. Bad escape character  (ZMODEM)
  389. >>Same as above
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                     - 6 -
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403. Bad hexadecimal character  (ZMODEM)
  404. >>XYZ.TTP was expecting a hexadecimal digit but got an character
  405.   that wasn't 0-9 or a-f.  Probably caused by line noise.
  406.  
  407. Bad or unsupported packet type  (ZMODEM)
  408. >>An unrecognized packet was received.  Either caused by line noise,
  409.   the sender being set to upload instead of download, or using ZMODEM
  410.   features XYZ.TTP doesn't support.  See "WHAT IT ISN'T" section.
  411.  
  412. Bad packet type <byte>  (ZMODEM/DEBUGGING)
  413. >>Same as above.  The type is specified.
  414.  
  415. Bad request  (XMODEM/YMODEM/ZMODEM)
  416. >>A serious error within either the ST's operating system or within XYZ.TTP
  417.   has occurred.
  418.  
  419. Bombs  (XMODEM/YMODEM/ZMODEM)
  420. >>Not the word "Bombs", but the little cartoon bombs on the left side of your
  421.   screen.  The 68000 processor has encountered an instruction that it can't
  422.   process.  This can be caused by a bad copy of XYZ.TTP, an interaction with
  423. a
  424.   desk accessory or program in the AUTO folder, or (most likely) a coding
  425.   boo-boo of mine.
  426.  
  427. Block #<block number>  (XMODEM/YMODEM)
  428. >>Number of the block being received.
  429.  
  430. Block resent, but not requested.  (XMODEM/YMODEM)
  431. >>A block was retransmitted, but XYZ.TTP did not request it.  Caused either
  432.   by line noise, or very slow responses by the sender.
  433.  
  434. <number> bytes transferred  (ZMODEM)
  435. >>Indicates how much of file has been received.
  436.  
  437. Buffer size = <size>  (XMODEM/YMODEM/ZMODEM)
  438. >>The number of bytes of memory that XYZ.TTP will use as a buffer.
  439.  
  440. Can't convert filename "<filename>", will use "<filename>"  (YMODEM/ZMODEM)
  441. >>The sender specified a filename that XYZ.TTP couldn't make compatible
  442.   with the Atari ST's operating system.  A random filename with the
  443.   extension .XYZ will be used.
  444.  
  445. Can't open error long  (XMODEM/YMODEM/ZMODEM)
  446. >>The filename specified with the -v (verbose) option can't be opened.  The
  447. output will go to the screen instead.
  448.  
  449. Checksum error  (XMODEM)
  450. >>The checksum on the last block was invalid.  Probably caused by line
  451.   noise.
  452.  
  453. Command received, but commands not  supported  (ZMODEM)
  454. >>XYZ.TTP does not accept commands from remote systems.  See "WHAT IT ISN'T"
  455.   section.
  456.  
  457.  
  458.  
  459.  
  460.  
  461.                                     - 7 -
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469. Command: <command>  (ZMODEM)
  470. >>Text of command received.  See above.
  471.  
  472. CRC error  (XMODEM/YMODEM/ZMODEM)
  473. >>The CRC on the last block was invalid.  Probably caused by line noise.
  474.  
  475. Crc error (as part of file error message)
  476. >>The ST detected an error while accessing the disk.  The disk may be
  477. damaged.
  478.  
  479. Disk full!  (XMODEM/YMODEM/ZMODEM)
  480. >>There isn't enough room on your disk to hold the file.  The transfer is
  481.   aborted, with as much of the file as the disk will hold saved.  You can
  482.   resume the transfer in ZMODEM if you move the partial file to another
  483.   disk that has more room, or if you delete some files on the disk.
  484.  
  485. Downloading YMODEM  (YMODEM)
  486. >>A YMODEM session has started.
  487.  
  488. Drive not ready  (XMODEM/YMODEM/ZMODEM)
  489. >>The disk drive isn't responding.  Make sure the drive is attached, turned
  490.   on, and has a formatted disk in it.
  491.  
  492. Duplicate YMODEM header received.  Ignored.  (YMODEM)
  493. >>A file specification block was retransmitted, but it was not requested.
  494.   Caused by line noise, very slow responses from the sender, or operating
  495.   XYZ.TTP in XMODEM mode when the sender is using YMODEM.
  496.  
  497. Error in positioning file pointer:  <error type>  (ZMODEM)
  498. >>XYZ.TTP tries to find the end of the file after it opens it.  If it can't,
  499.   you get this message.  Look up the error type that prints out to find
  500.   out what error occurred.
  501.  
  502. Error in seeking to end of file:  <error type>  (XMODEM/YMODEM/ZMODEM)
  503. >>Same as above.
  504.  
  505. Error opening file:  <error type>  (XMODEM/YMODEM/ZMODEM)
  506. >>XYZ.TTP could not open a file.  Look up the error type that prints out to
  507.   find out what error occurred.
  508.  
  509. Error writing to file:  <error type>  (XMODEM/YMODEM/ZMODEM)
  510. >>An error occurred while XYZ.TTP was trying to write to a file.  Look up the
  511.   error type that prints out to find out what error occurred.
  512.  
  513. File <filename> exists!  (XMODEM/YMODEM)
  514. >>XMODEM and YMODEM will not overwrite a file that already exists.  Specify
  515.   a different file name (XMODEM) or path (YMODEM), or delete the file that
  516.   already exists.
  517.  
  518. File created on <time & date>  (YMODEM/ZMODEM)
  519. >>The time the file being received was created.
  520.  
  521. File created on <time & date>, reset to <time & date>  (YMODEM/ZMODEM)
  522. >>The time the file being received was created.  This will be changed to
  523.  
  524.  
  525.  
  526.  
  527.                                     - 8 -
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.   the current time and date.
  536.  
  537. File creation date not specified, reset to <time & date>  (YMODEM/ZMODEM)
  538. >>The sender did not specify a creation time; therefore the current time
  539.   will be put on the file.
  540.  
  541. File error  (XMODEM/YMODEM/ZMODEM)
  542. >>A file error occurred while writing to the disk.  Caused by a full disk, a
  543.   bad filename, specifying a folder that doesn't exist, or a disk error.
  544.  
  545. File error at sender  (ZMODEM)
  546. >>A file error occurred at the sender, so it is aborting the transfer.
  547.  
  548. File exists -- transfer resuming at offset <offset>  (ZMODEM)
  549. >>The file that is being transferred already exists, so it is assumed that
  550.   an aborted transfer is being resumed.
  551.  
  552. File not found  (XMODEM/YMODEM/ZMODEM)
  553. >>XYZ.TTP tried to read from a file that didn't exist.  You should never
  554.   get this error since XYZ.TTP should not read files.  If you do, something
  555.   is seriously wrong.
  556.  
  557. File pos = <position>, sender = <position>  (ZMODEM/DEBUGGING)
  558. >>XYZ.TTP and the sender disagree over how much of the file has been sent.
  559.   The position each claims is specified.
  560.  
  561. File position error  (ZMODEM)
  562. >>XYZ.TTP and the sender disagree over how much of the file has been sent.
  563.  
  564. Function domain  (XMODEM/YMODEM/ZMODEM)
  565. Function range
  566. Fundamental error
  567. General error
  568. >>These are all internal errors in the ST's operating system.  You should
  569.   never get them.  If you do, you will probably have to reboot the computer.
  570.  
  571. Got a session abort while waiting for ZPAD  (DEBUGGING)
  572. >>The sender sent a series of CTRL-X's, or "CANcels," while XYZ.TTP was
  573. waiting for the start of a ZMODEM frame.
  574.  
  575. Got a GOTCAN  (DEBUGGING)
  576. >>The sender sent a session abort sequence (a series of CTR-X's, or "CANcels")
  577. while XYZ.TTP was waiting for a character
  578.  
  579. Got a ZRPOS!  (ZMODEM)
  580. >>This packet type is reserved for the receiving side.  Make sure the sender
  581.   is set to download.
  582.  
  583. Got a ZSKIP?!?  (ZMODEM)
  584. >>This packet type is reserved for the receiving side.  Make sure the sender
  585.   is set to download.
  586.  
  587. Got: <frame type> <header> <hex bytes> CRC <CRC value>  (ZMODEM/DEBUGGING)
  588. >>This details a ZMODEM packet that was received.
  589.  
  590.  
  591.  
  592.  
  593.                                     - 9 -
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602. Got ZCRC '%c'  (ZMODEM)
  603. >>This indicates tells the CRC type at the end of the last data subpacket.
  604.  
  605. Insufficient memory  (XMODEM/YMODEM/ZMODEM)
  606. >>Either your computer does not have enough memory for XYZ.TTP to run, or
  607.   something has gone wrong with the way the memory is being managed.  Try
  608.   removing desk accessories and/or programs in the AUTO folder to free
  609.   up some memory.
  610.  
  611. Internal error (XMODEM/YMODEM/ZMODEM)
  612. >>An error has occurred within the ST's operating system.  You will probably
  613.   have to reboot the computer.
  614.  
  615. Invalid drive specified  (XMODEM/YMODEM/ZMODEM)
  616. >>You specified a drive in the path name that does not exist.  Be sure the
  617.   drive letter you specified was correct, and the disk is connected and
  618.   turned on.
  619.  
  620. Invalid function number  (XMODEM/YMODEM/ZMODEM)
  621. Invalid handle
  622. Invalid memory block address
  623. >>A serious internal error in XYZ.TTP or the ST's operating system has
  624.   occurred.
  625.  
  626. <filename> has been renamed to <filename>  (YMODEM/ZMODEM)
  627. >>A filename was specified by the sender that is incompatible with the Atari
  628.   ST's operating system.  It has been transformed into a valid filename
  629.   that should still be recognizable, though you may have to manually rename
  630.   it before using it.
  631.  
  632. Invalid option <option>  (XMODEM/YMODEM/ZMODEM)
  633. >>You put an option on the command line that XYZ.TTP does not recognize.
  634.   A list of the valid options is printed out.
  635.  
  636. <filename> is a duplicate filename  (XMODEM/YMODEM/ZMODEM)
  637. >>You put more than one filename (XMODEM) or more than one path (XMODEM/
  638.   YMODEM) on the command line.  Only specify one.
  639.  
  640. Media change (XMODEM/YMODEM/ZMODEM)
  641. >>You removed the disk from the drive while XYZ.TTP was writing a file to
  642.   it.  NEVER remove a floppy disk until after XYZ.TTP has finished running.
  643.  
  644. Memory free: <# of bytes>  (DEBUGGING)
  645. >>Shows the amount of memory left free before XYZ.TTP allocates its buffers.
  646.  
  647. Message: <text>  (ZMODEM)
  648. >>The remote system sent a message.
  649.  
  650. Missing block number  (XMODEM/YMODEM)
  651. >>A valid block number was not received.  Probably caused by line noise.
  652.  
  653. Missing or bad header  (XMODEM/YMODEM)
  654. >>The block header was not sent completely or was garbled.  Probably caused
  655.  
  656.  
  657.  
  658.  
  659.                                     - 10 -
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.   by line noise.
  668.  
  669. No filename  (XMODEM)
  670. >>You must specify a filename for XMODEM transfers.
  671.  
  672. No handles left  (XMODEM/YMODEM/ZMODEM)
  673. >>The ST has too many files open.  If you are running XYZ.TTP from within
  674.   another program that opens files without closing them, this error might
  675.   occur.  Otherwise, it indicates an internal error in the ST's operating
  676.   system.
  677.  
  678. Not enough memory to allocate buffers
  679. >>There isn't enough free memory to run XYZ.TTP.  Remove some of your desk
  680.   accessories, or run XYZ.TTP from the desktop rather than from within a
  681.   terminal program.
  682.  
  683. Path not found  (XMODEM/YMODEM/ZMODEM)
  684. >>The path you specified on the command line does not exist.  All the folders
  685.   in the path must have already been created before you run XYZ.TTP.
  686.  
  687. Press any key to exit....  (XMODEM/YMODEM/ZMODEM)
  688. >>The -p option was put on the command line, and XYZ.TTP is about to
  689.   terminate.  Press a key to let it complete its termination.
  690.  
  691. Range error  (XMODEM/YMODEM/ZMODEM)
  692. >>A serious internal error has occurred within either the ST's operating
  693.   system or within XYZ.TTP.
  694.  
  695. Read fault  (XMODEM/YMODEM/ZMODEM)
  696. >>An error occurred while the ST was trying to read from a disk.  The disk
  697.   may be damaged.
  698.  
  699. Receiving file "<filename>", <size> bytes  (ZMODEM)
  700. >>The transfer of a file has begun.  The size is specified by the sender,
  701.   and may not be the actual size of the file.
  702.  
  703. Receiving file "<filename>", size not specified  (ZMODEM)
  704. >>The transfer of a file has begun.  The size of the file was not specified.
  705.  
  706. Sector not found  (XMODEM/YMODEM/ZMODEM)
  707. >>Something has gone wrong with the ST's file system.  It tried to read a
  708.   disk sector that does not exist.
  709.  
  710. Seek error  (XMODEM/YMODEM/ZMODEM)
  711. >>Something went wrong when the ST tried to make the disk go to a specific
  712.   track.
  713.  
  714. Sender aborted  (ZMODEM)
  715. >>The sending program is aborting the transfer.
  716.  
  717. Sender indicates end of file, but file length is wrong  (ZMODEM)
  718. >>The sender has come to the end of the file, but the number of bytes it
  719.   says it sent does not match the number of bytes XYZ.TTP has received.
  720.  
  721.  
  722.  
  723.  
  724.  
  725.                                     - 11 -
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733. Sender not ready or set to receive  (ZMODEM)
  734. >>The sender is echoing back XYZ.TTP's packets, or is set to upload.  Make
  735.   sure it is set to download.
  736.  
  737. Sender requested CRC?!?  (ZMODEM)
  738. >>This packet type is reserved for the receiver.  Make sure the sender is set
  739.   to download
  740.  
  741. Sender requests retransmission  (ZMODEM)
  742. >>The sender wants XYZ.TTP to resend a packet.  Probably due to line noise.
  743.  
  744. Sender sent ZCHALLENGE?!?  (ZMODEM)
  745. >>This packet type is reserved for the receiver.  Make sure the sender is set
  746.   to download
  747.  
  748. Sender sent ZCOMPL -- ignored  (ZMODEM)
  749. >>The sender indicates it completed a command, but XYZ.TTP doesn't issue
  750.   commands.
  751.  
  752. Sent: <header> <hex bytes> CRC <CRC value>  (ZMODEM/DEBUGGING)
  753. >>Details of a hex-style packet that XYZ.TTP has sent.
  754.  
  755. Setblock failure due to growth restrictions  (XMODEM/YMODEM/ZMODEM)
  756. >>Something has gone wrong with the ST's memory management.
  757.  
  758. Subpacket bad CRC: <CRC value>  (ZMODEM/DEBUGGING)
  759. >>An invalid CRC was received at the end of a data subpacket.  Probably due
  760.   to line noise.
  761.  
  762. Subpacket too long  (ZMODEM)
  763. >>A data subpacket has exceeded 1k in length, or an attention string is over
  764.   32 bytes long.  Probably due to line noise.
  765.  
  766. Synchronization error  (XMODEM/YMODEM)
  767. >>The sender is sending the wrong packet.  Probably caused by either line
  768.   line noise or very slow responses from the sender.
  769.  
  770. Timed out  (XMODEM/YMODEM/ZMODEM)
  771. >>Too much time has passed since the last character was received.  Probably
  772.   caused by line noise, very slow responses from the sender, or failure
  773.   of the sender.
  774.  
  775. To abort, press UNDO at any time  (XMODEM/YMODEM/ZMODEM)
  776. >>This just informs you that you can abort a transfer by pressing UNDO.
  777.  
  778. Too many retries  (XMODEM/YMODEM/ZMODEM)
  779. >>Too many errors have occurred.  The session is aborted.
  780.  
  781. Transfer of <filename> complete, <size> bytes  (XMODEM/YMODEM)
  782. >>Transfer of a file complete successfully.  The filename and actual size
  783.   is indicated.
  784.  
  785. Unexpected ZACK from sender!  (ZMODEM)
  786. >>This packet type is reserved for the receiver.  Make sure the sender is
  787.  
  788.  
  789.  
  790.  
  791.                                     - 12 -
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.   set to download.
  800.  
  801. Unknown device  (XMODEM/YMODEM/ZMODEM)
  802. >>You didn't specify a valid drive letter in the pathname on the command
  803.   line.
  804.  
  805. Unknown media  (XMODEM/YMODEM/ZMODEM)
  806. >>The disk you are trying to use is not formatted correctly.
  807.  
  808. Usage:  xyz.ttp [options] <path>
  809. >>Prints in response to the -h (help) option, or an invalid option.  A list
  810.   of all possible options follows.
  811.  
  812. Use -c (checksum) mode with XMODEM only  (YMODEM/ZMODEM)
  813. >>Checksum mode is only valid with XMODEM.
  814.  
  815. User aborted  (XMODEM/YMODEM/ZMODEM)
  816. >>You have pressed the UNDO key, and the session has been aborted.
  817.  
  818. Verbose mode is on!  (DEBUGGING)
  819. >>The -v option was specified.  Special debugging information will be
  820.   written to the screen or a specified file.
  821.  
  822. Write fault  (XMODEM/YMODEM/ZMODEM)
  823. >>An error occurred while XYZ.TTP was trying to write to the disk.  The
  824.   disk may be damaged.
  825.  
  826. Write protect  (XMODEM/YMODEM/ZMODEM)
  827. >>The write protect window on the disk is open.
  828.  
  829. YMODEM complete!  (YMODEM)
  830. >>YMODEM session has completed.
  831.  
  832. YMODEM packet received, but doing XMODEM.  (XMODEM)
  833. >>A YMODEM file specification was received, but XYZ.TTP is set to do an
  834.   XMODEM transfer.  Make sure you select the same mode for both XYZ.TTP and
  835.   the remote system.
  836.  
  837. YMODEM transfer aborted!  (YMODEM)
  838. >>An error has occurred, and the YMODEM session is being aborted.
  839.  
  840. ZBIN Bad CRC: <CRC value>  (ZMODEM/DEBUGGING)
  841. >>An invalid CRC was at the end of a binary-style packet.  The CRC value is
  842.   specified.
  843.  
  844. ZEOF = 0x%lx, f_offset = 0x%lx  (ZMODEM/DEBUGGING)
  845. >>The sender is claiming end-of-file, but XYZ.TTP hasn't received all of it.
  846.   The file size the sender specifies and the amount XYZ.TTP has received is
  847.   printed.
  848.  
  849. ZHEX Bad CRC: <CRC value>  (ZMODEM/DEBUGGING)
  850. >>An invalid CRC was at the end of a hex-style packet.  The CRC value is
  851.   specified.
  852.  
  853.  
  854.  
  855.  
  856.  
  857.                                     - 13 -
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865. ZMODEM file transfer  (ZMODEM)
  866. >>A ZMODEM session has started.
  867.  
  868. ZMODEM transfer complete.  (ZMODEM)
  869. >>A ZMODEM session has completed.
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.                                     - 14 -
  924.  
  925.